home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / OzTeX3.0 / Help-files / DVIPS < prev    next >
Text File  |  1997-01-28  |  12KB  |  267 lines
  1. A summary of the dvips options:
  2.  
  3. -a*   Conserve memory, not time       -y #  Multiply by dvi magnification
  4. -b #  Page copies, for posters e.g.   -z*   Generate HyperPostScript
  5. -c #  Uncollated copies               -A    Print only odd (TeX) pages
  6. -d #  Debugging                       -B    Print only even (TeX) pages
  7. -e #  Maxdrift value                  -C #  Collated copies
  8. -f*   Run as filter                   -D #  Resolution
  9. -h f  Add header file                 -E*   Try to create EPSF
  10. -i*   Separate file per section       -F*   Send control-D at end
  11. -j*   Download fonts partially        -K*   Pull comments from inclusions
  12. -k*   Print crop marks                -M*   Don't make fonts
  13. -l #  Last page                       -N*   No structured comments
  14. -m*   Manual feed                     -O c  Set/change paper offset
  15. -n #  Maximum number of pages         -P s  Load config.$s
  16. -o f  Output file                     -R    Run securely
  17. -p #  First page                      -S #  Max section size in pages
  18. -pp l Select list of pages            -T c  Specify desired page size
  19. -q*   Run quietly                     -U*   Disable string param trick
  20. -r*   Reverse order of pages          -V*   Send downloadable PS fonts as PK
  21. -s*   Enclose output in save/restore  -X #  Horizontal resolution
  22. -t s  Paper format                    -Y #  Vertical resolution
  23. -x #  Override dvi magnification      -Z*   Compress bitmap fonts
  24.  
  25.    # = number    f = file    s = string    * = suffix, `0' to turn off
  26.    c = comma-separated dimension pair (eg. 3.2in,-32.1cm)
  27.    l = comma-separated list of pages and ranges (eg. 3,5-10,13)
  28.  
  29. More details:
  30.  
  31. -a
  32. Conserve memory by making three passes over the .dvi file
  33. instead of two and only loading those characters actually used.
  34. Generally only useful on machines with a very limited amount of memory.
  35.  
  36. -A
  37. Print only odd pages (TeX pages, not sequence pages).
  38.  
  39. -b num
  40. Generate num copies of each page, but duplicating the page body rather
  41. than using the c or C options.  This can be useful in conjunction with a
  42. header file setting bop-hook to do color separations or other neat tricks.
  43.  
  44. -B
  45. Print only even pages (TeX pages, not sequence pages).
  46.  
  47. -c num
  48. Generate num copies of every page.  Default is 1.  (For collated copies,
  49. see the -C option below.)
  50.  
  51. -C num
  52. Create num copies, but collated (by replicating the data in the PostScript
  53. file).  Slower than -c, but easier on the hands, and faster than sending
  54. the same PostScript file multiple times.
  55.  
  56. -d num
  57. Set the debug flags.  This is intended only for emergencies or for unusual
  58. fact-finding expeditions.  To track a certain class of debug messages,
  59. simply provide the appropriate number given below; if you wish to track
  60. multiple classes, sum the numbers of the classes you wish to track.
  61. Use a value of -1 for maximum output.  The classes are:
  62.     1   specials
  63.     2   paths
  64.     4   fonts
  65.     8   pages
  66.    16   headers
  67.    32   font compression
  68.    64   files
  69.   128   memory
  70.  
  71. -D num
  72. Set the resolution in dpi (dots per inch) to num.
  73. This affects the choice of bitmap fonts that are loaded and also the
  74. positioning of letters in resident PostScript fonts.  Must be between 10
  75. and 10000.  This affects both the horizontal and vertical resolution.
  76. If a high resolution (something greater than 400 dpi, say) is selected,
  77. the -Z flag should probably also be used.
  78.  
  79. -e num
  80. Make sure that each character is placed at most this many pixels from its
  81. `true' resolution-independent position on the page. The default value of this
  82. parameter is resolution dependent.  Allowing individual characters to `drift'
  83. from their correctly rounded positions by a few pixels, while regaining the
  84. true position at the beginning of each new word, improves the spacing of
  85. letters in words.
  86.  
  87. -E
  88. Makes dvips attempt to generate an EPSF file with a tight bounding box.
  89. This only works on one-page files, and it only looks at marks made
  90. by characters and rules, not by any included graphics.  In addition, it
  91. gets the glyph metrics from the tfm file, so characters that lie outside
  92. their enclosing tfm box may confuse it.  In addition, the bounding box might
  93. be a bit too loose if the character glyph has significant left or right side
  94. bearings.  Nonetheless, this option works well for creating small EPSF files
  95. for equations or tables or the like.  (Note, of course, that dvips output is
  96. resolution dependent and thus does not make very good EPSF files, especially
  97. if the images are to be scaled; use these EPSF files with a great deal of
  98. care.)
  99.  
  100. -f
  101. Running as a filter makes no sense on the Mac, so this option is not
  102. supported by OzTeX.
  103.  
  104. -F
  105. Causes Control-D (ASCII code 4) to be appended as the very last character
  106. of the PostScript file.  NOTE! DO NOT USE THIS OPTION!
  107.  
  108. -h name
  109. Prepend given file as an additional header file. (However, if the name is
  110. simply `-' suppress all header files from the output.)  This header file
  111. gets added to the PostScript userdict.
  112.  
  113. -i
  114. Make each section be a separate file.  Under certain circumstances, dvips
  115. will split the document up into `sections' to be processed independently;
  116. this is most often done for memory reasons.  Using this option tells dvips
  117. to place each section into a separate file; the new file names are created
  118. replacing the suffix of the supplied output file name by a three-digit
  119. sequence number.  This option is most often used in conjunction with
  120. the -S option which sets the maximum section length in pages.
  121. For instance, some phototypesetters cannot print more than ten or so
  122. consecutive pages before running out of steam; these options can be used
  123. to automatically split a book into ten-page sections, each to its own file.
  124.  
  125. -j
  126. Type 1 PostScript fonts are partially downloaded.  If such fonts are used
  127. in the .dvi file then the size of the .ps file will be reduced.
  128. This option is off by default.
  129.  
  130. -k
  131. Print crop marks.  This option increases the paper size (which should be
  132. specified, either with a paper size special or with the -T option) by a
  133. half inch in each dimension.  It translates each page by a quarter inch
  134. and draws cross-style crop marks.  It is mostly useful with typesetters
  135. that can set the page size automatically.
  136.  
  137. -K
  138. This option causes comments in included PostScript graphics, font files,
  139. and headers to be removed.  This is sometimes necessary to get around bugs
  140. in spoolers or PostScript post-processing programs.  Specifically, the
  141. %%Page comments, when left in, often cause difficulties.
  142. Use of this flag can cause some included graphics to fail, since the
  143. PostScript header macros from some software packages read portions of
  144. the input stream line by line, searching for a particular comment.
  145.  
  146. -l num
  147. The last page printed will be the first one numbered num.
  148. Default is the last page in the document.  If num is prefixed by an equals
  149. sign, then it (and any argument to the -p option) is treated as a sequence
  150. number, rather than a value to compare with count0 values.
  151. Thus, using -l=9 will end with the ninth page of the document,
  152. no matter what the pages are actually numbered.
  153.  
  154. -m
  155. Specify manual feed for printer.
  156.  
  157. -M
  158. Turns off the automatic font making facility.  If any fonts are missing,
  159. commands to generate the fonts are appended to the file missfont.make;
  160. this file can be given to MakeTeXPK in OzMF to create the missing fonts.
  161. For compatibility with OzTeX, -M is the default action.
  162.  
  163. -n num
  164. At most num pages will be printed.  Default is 100000.
  165.  
  166. -N
  167. Turns off structured comments; this might be necessary on some systems
  168. that try to interpret PostScript comments in weird ways, or on some
  169. PostScript printers.  Old versions of TranScript in particular cannot
  170. handle modern Encapsulated PostScript.
  171.  
  172. -o name
  173. The output will be sent to the given file.
  174. If no file name is given, the default name is file.ps where the .dvi file
  175. was called file.dvi.
  176.  
  177. -O offset
  178. Move the origin by a certain amount.  The offset is a comma-separated pair
  179. of dimensions, such as .1in,-.3cm.  The origin of the page is shifted from
  180. the default position (of one inch down, one inch to the right from the upper
  181. left corner of the paper) by this amount.
  182.  
  183. -p num
  184. The first page printed will be the first one numbered num.
  185. Default is the first page in the document.  If the num is prefixed by an
  186. equals sign, then it (and any argument to the -l option) is treated as a
  187. sequence number, rather than a value to compare with count0 values.
  188. Thus, using -p=3 will start with the third page of the document,
  189. no matter what the pages are actually numbered.
  190.  
  191. -pp pagelist
  192. A comma-separated list of pages and ranges (a-b) may be given, which will
  193. be interpreted as count0 values.  Pages not specified will not be printed.
  194. Multiple -pp options may be specified or all pages and page ranges can be 
  195. specified with one -pp option.
  196.  
  197. -P printername
  198. Sets up the output for the appropriate printer.  This is implemented
  199. by reading in config.printername, which can then set the font paths and
  200. any other config.ps defaults for that printer only.  Note that config.ps
  201. is read before config.printername.
  202.  
  203. -q
  204. Run in quiet mode.  Reports nothing but errors.
  205.  
  206. -r
  207. Stack pages in reverse order.  Normally, page 1 will be printed first.
  208.  
  209. -s
  210. Causes the entire global output to be enclosed in a save/restore pair.
  211. This causes the file to not be truly conformant, and is thus not recommended,
  212. but is useful if you are driving the printer directly and don't care too
  213. much about the portability of the output.
  214.  
  215. -S num
  216. Set the maximum number of pages in each `section'.  This option is most
  217. commonly used with the -i option; see that documentation above for more
  218. information.
  219.  
  220. -t papertype
  221. This sets the paper type to papertype.
  222. The papertype should be defined in one of the configuration files, along
  223. with the appropriate code to select it.  (Currently known types include
  224. letter, legal, ledger, a4, a3.)  You can also specify -t landscape,
  225. which rotates a document by 90 degrees.  To rotate a document whose size is
  226. not letter, you can use the -t option twice, once for the page size, and once
  227. for landscape.  The upper left corner of each page in the .dvi file is placed
  228. one inch from the left and one inch from the top.  Use of this option is
  229. highly dependent on the configuration file.  Note that executing the letter
  230. or a4 or other PostScript operators cause the document to be nonconforming
  231. and can cause it not to print on certain printers, so the paper size should
  232. not execute such an operator if at all possible.
  233.  
  234. -T dim,dim
  235. Set the paper size to the given pair of dimensions.  It overrides any
  236. paper size special in the dvi file.
  237.  
  238. -U
  239. Disable a PostScript virtual memory saving optimization that stores the
  240. character metric information in the same string that is used to store
  241. the bitmap information.  This is only necessary when driving the Xerox
  242. 4045 PostScript interpreter.  It is caused by a bug in that interpreter
  243. that results in `garbage' on the bottom of each character.
  244. Not recommended unless you must drive this printer.
  245.  
  246. -x num
  247. Set the magnification ratio to num/1000.  Overrides the magnification
  248. specified in the .dvi file.  Must be between 10 and 100000.
  249.  
  250. -X num
  251. Set the horizontal resolution in dots per inch to num.
  252.  
  253. -Y num
  254. Set the vertical resolution in dots per inch to num.
  255.  
  256. -Z
  257. Causes bitmapped fonts to be compressed before they are downloaded,
  258. thereby reducing the size of the PostScript font-downloading information.
  259. Especially useful at high resolutions or when very large fonts are used.
  260. Will slow down printing somewhat, especially on early 68000-based
  261. PostScript printers.
  262.  
  263. -z
  264. If the .dvi file contains HyperTeX \specials then dvips will generate
  265. PostScript code suitable for conversion to PDF (eg. by Distiller).
  266. This option is off by default.
  267.